home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Network Support Library
/
RoseWare - Network Support Library.iso
/
drivers
/
ibmtro.exe
/
IBMTRDBO.DOC
< prev
next >
Wrap
Text File
|
1993-03-09
|
57KB
|
1,692 lines
ODI FOR IBM LANSTREAMER ADAPTER, VERSION 1.0 MARCH 26, 1993
About This File . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Supported Platforms . . . . . . . . . . . . . . . . . . . . . . . . . . 2
IBMTRDBO LAN Driver Installation Procedure . . . . . . . . . . . . . . 2
NetWare Server . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Configurable IBMTRDBO LAN Driver Parameters . . . . . . . . . . . . . . 5
Sample IBMTRDBO.CFG Configuration File for NetWare Server . . . . . . . 7
IBMTRDBO LAN Driver Performance Tuning . . . . . . . . . . . . . . . . 8
NetWare Server . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
IBM LANStreamer Adapter Custom Statistic Counters . . . . . . . . . . . 9
Messages for the IBMTRDBO LAN Driver . . . . . . . . . . . . . . . . 12
(C) Copyright IBM Corp. 1993 1
ABOUT THIS FILE
This file describes the use of the IBMTRDBO LAN driver with the IBM
LANStreamer Adapter. This LAN driver supports the IBM LANStreamer Adapter in
the Novell Netware environment.
This file is an extension of the IBM LANSTREAMER INSTALLATION AND TESTING
INSTRUCTIONS that are shipped with the adapter. This file describes the
installation and configuration of the IBM LANStreamer Open Datalink Interface
(ODI) IBMTRDBO LAN driver. It contains information about the following
topics:
o Supported platforms
o Software installation procedures
o Configurable IBMTRDBO LAN driver parameters
o Performance tuning the IBMTRDBO LAN driver
o IBM LANStreamer Adapter Custom Statistic Counters
o Messages for the IBMTRDBO LAN driver
SUPPORTED PLATFORMS
The IBMTRDBO LAN driver is supported in any of the hardware environments
supported by the IBM LANStreamer Adapter. See the IBM LANSTREAMER
INSTALLATION AND TESTING INSTRUCTIONS for information about supported
hardware.
The following operating system environments are supported:
o Novell NetWare 3.1x
o Novell NetWare 4.0
IBMTRDBO LAN DRIVER INSTALLATION PROCEDURE
This section describes how to install the IBMTRDBO LAN driver on the NetWare
Server platform.
See the IBM LANSTREAMER INSTALLATION AND TESTING INSTRUCTIONS that is shipped
with the adapter for instructions on how to install the IBM LANStreamer
Adapter.
ODI for IBM LANStreamer Adapter, Version 1.0 March 26, 1993 2
NetWare Server
This section describes how to install the IBMTRDBO LAN driver on a NetWare
Server.
To install the IBMTRDBO LAN driver on a NetWare Server, perform the following
steps:
1. Choose a target directory path on the diskette or the fixed disk (for
example, C:\NW) for installation of the IBMTRDBO LAN driver and its
associated files. All files (in step 2, below) should be copied to this
target directory.
2. Copy the following files to the target directory:
o PATCHMAN.NLM
o LSLENH.NLM
o IBMTRDBO.LAN
o MSM31X.NLM
o TOKENTSM.NLM
3. Add the following lines to the STARTUP.NCF file:
Set Minimum Packet Receive Buffers = 64
Set Maximum Physical Receive Packet Size = 4500
NOTES:
1. If running on NetWare 3.1x add,
Set Maximum Physical Receive Packet Size = 4202
2. If the IBM LANStreamer Adapter is installed in a 16-bit
slot in your computer, add,
Set Reserved Buffers Below 16 Meg = 64
4. Add the following line to the AUTOEXEC.NCF file:
LOAD C:\NW\PATCHMAN.NLM
LOAD C:\NW\LSLENH.NLM
LOAD C:\NW\IBMTRDBO.LAN @IBMTRDBO.CFG
NOTES:
a. @IBMTRDBO.CFG is an optional command line parameter (see step 5,
below).
b. IBMTRDBO.LAN automatically loads MSM.NLM (MSM31X.NLM if running
Novell NetWare 3.1x) and TOKENTSM.NLM.
ODI for IBM LANStreamer Adapter, Version 1.0 March 26, 1993 3
See NOVELL NETWARE SYSTEM ADMINISTRATION for more information about the
AUTOEXEC.NCF and STARTUP.NCF files.
5. If you need to change any IBMTRDBO LAN driver parameter values from their
defaults, these parameters can be specified on the command line when the
IBMTRDBO LAN driver is loaded, or they can be specified by creating an
IBMTRDBO.CFG configuration file. If the optional @IBMTRDBO.CFG command
line parameter is used to specify an IBMTRDBO.CFG configuration file,
then the configuration file must be located in the same directory as the
IBMTRDBO.LAN file. You can use any text editor to create or edit the
IBMTRDBO.CFG file. See "Sample IBMTRDBO.CFG Configuration File for
NetWare Server" for a sample IBMTRDBO.CFG file.
6. If you run the MONITOR.NLM program at your NetWare server, obtain the
latest copy of the MONITOR.NLM program from Novell. Update your NetWare
servers with the latest copy of the MONITOR.NLM program.
7. Obtain the latest copy of the LSLENH.NLM patch for NetWare from Novell.
Load this patch in the AUTOEXEC.NCF when you bring up the NetWare server.
ODI for IBM LANStreamer Adapter, Version 1.0 March 26, 1993 4
CONFIGURABLE IBMTRDBO LAN DRIVER PARAMETERS
The following parameters can be configured at the NetWare Server by setting
keywords on the command line and in the IBMTRDBO.CFG file. A sample
IBMTRDBO.CFG file is shown in "Sample IBMTRDBO.CFG Configuration File for
NetWare Server."
SLOT
This keyword defines the slot number of the corresponding IBM
LANStreamer Adapter in the computer. To avoid being prompted to enter
a slot number when the IBMTRDBO LAN driver is loaded, specify this
keyword in the AUTOEXEC.NCF file. This keyword must be within the
range of 1-8.
FRAME
This keyword defines the frame type used with the IBM LANStreamer
Adapter. The default is TOKEN-RING. The value for this keyword must
be one of the following ascii strings:
o TOKEN-RING
o TOKEN-RING_SNAP
To set a locally administered address for the adapter, type in the
local address you want to use. The local address must contain 12
hexadecimal characters and can be specified in either MSB (Most
Significant Bit: default) or LSB (Least Significant Bit) format. To
specify a MSB node address the letter "M" immediately follows the last
digit of the node address. To specify a LSB node address the letter
"L" immediately follows the last digit of the node address. Since MSB
is the default format for the node address parameter, the use of a
letter "M" at the end of a node address is for clarity. This keyword
is specified on the command line or in the IBMTRDBO.CFG as NODE for
the NetWare Server. See "Sample IBMTRDBO.CFG Configuration File for
NetWare Server" for a sample IBMTRDBO.CFG file.
If a node address is specified in MSB format, the characters must be
within the range 400000000000-7FFFFFFFFFFF (for example,
400000000001M). This address specified in LSB format would be
020000000080L with an "L" appended to the end.
NOTES:
1. Do not assign the same local address to 2 or more stations.
Severe station communication or network failures may occur when 2
or more stations are assigned the same address.
2. If you do not assign a locally administered address, the adapter
uses the universally administered address permanently embedded on
the adapter.
RXBUFFERS
This keyword defines the number of receive buffers used by the
IBMTRDBO LAN driver.
ODI for IBM LANStreamer Adapter, Version 1.0 March 26, 1993 5
The value for this keyword must be: 4, 8, 16, 32, or 64; the default
is 32. (Receive buffer size is defined by the server SET command.
See NOVELL NETWARE SYSTEM ADMINISTRATION for more information.)
TXBUFFERS
This keyword defines the number of transmit buffers used by the
IBMTRDBO LAN driver.
The value for this keyword must be: 1, 2, 4, 8, or 16; the default is
16. (Receive buffer size is defined by the server SET command. See
NOVELL NETWARE SYSTEM ADMINISTRATION for more information.)
TXINTSOFF
This keyword will reduce CPU utilization in server environments when
using the standard IPX protocol. Reducing CPU utilization (shown on
the monitor screen) may improve performance if CPU utilization is very
high (above 80% utilized). This option should not be used if Novell's
packet burst protocol (PBURST.NLM) is loaded, as performance on packet
burst links may be significantly degraded. Use of this option is
recommended only for servers using the standard IPX protocol.
ODI for IBM LANStreamer Adapter, Version 1.0 March 26, 1993 6
SAMPLE IBMTRDBO.CFG CONFIGURATION FILE FOR NETWARE SERVER
; The following keywords are generic ODI keywords for IBMTRDBO:
NODE=400000000002M
SLOT=2
FRAME=TOKEN-RING
; The following keywords are custom keywords for IBMTRDBO:
TXBUFFERS=16
RXBUFFERS=32
ODI for IBM LANStreamer Adapter, Version 1.0 March 26, 1993 7
IBMTRDBO LAN DRIVER PERFORMANCE TUNING
This section describes how to get the best performance from the IBM
LANStreamer Adapter and IBMTRDBO LAN driver.
NetWare Server
The maximum frame size that can be sent or received by the IBM LANStreamer
Adapter configured at a 4-Mbps data rate is 4494 bytes and at a 16-Mbps data
rate is 17954 bytes. Since frame sizes are typically negotiated between the
NetWare server and workstations, it is best to configure receive buffer sizes
at the server that equal the maximum transmit buffer size at workstations.
For this reason, increasing your receive buffer size to a value that is too
big only increases the amount of memory that is used by NetWare and may not
increase the performance of the IBM LANStreamer Adapter or NetWare.
Since the IBMTRDBO.LAN driver uses NetWare receive buffers to receive frames,
the size of receive buffers used by the IBMTRDBO.LAN driver is configurable
by changing the size of the NetWare receive buffers. Create or edit the
STARTUP.NCF file and add the following line to change the size of the receive
buffers:
Set Maximum Physical Receive Packet Size = 4202
NOTE: If running on NetWare 3.1x, 4202 bytes is the
maximum configurable receive buffer size.
See "Configurable IBMTRDBO LAN Driver Parameters" regarding the TXINTSOFF
keyword that may improve performance of the NetWare server.
ODI for IBM LANStreamer Adapter, Version 1.0 March 26, 1993 8
IBM LANSTREAMER ADAPTER CUSTOM STATISTIC COUNTERS
The custom statistic counters give the user information that is specific to
the IBM LANStreamer Adapter and IBMTRDBO LAN driver. There follow
descriptions of the custom statistic counters and what action, if any, should
you take based on these counters.
MAC Frame Count:
Description: This counter indicates the number of Media Access
Control (MAC) frames sent by the IBMTRDBO driver.
These MAC frames were built and requested to be
sent by a protocol stack.
Receive Frames Discarded
Description: This counter indicates the number of frames that were
received by the IBM LANStreamer Adapter but were
discarded by the IBMTRDBO LAN driver because they were
received with an error.
Cause/Action: If this counter steadily increases, it may indicate a
problem with your computer or the IBM LANStreamer Adapter.
Run the adapter diagnostic tests located on the
Option Diskette that were shipped with the IBM
LANStreamer Adapter. If there are no problems with
the adapter, reload the IBMTRDBO LAN driver.
If this problem persists, contact your network
administrator.
Transmit Frames Discarded
Description: This counter indicates the number of frames that could
not be transmitted by the IBM LANStreamer Adapter and were
discarded by the IBMTRDBO LAN driver.
Cause/Action: Possible explanations for this problem are as follows:
1. The token-ring is experiencing problems and,
therefore, the IBM LANStreamer Adapter could not
transmit these frames. If this problem persists,
contact your network administrator.
2. The IBM LANStreamer Adapter is not responding.
Run the adapter diagnostic tests located on
on the Option Diskette that was shipped with
the IBM LANStreamer Adapter. If there are no
problems with the adapter, reload the IBMTRDBO
driver. If a problem was found, follow the
instructions supplied with the diagnostic tests
to correct the problem.
ODI for IBM LANStreamer Adapter, Version 1.0 March 26, 1993 9
Adapter Hardware Errors
Description: This counter indicates the number of hardware errors
reported by the IBM LANStreamer Adapter.
Cause/Action: The IBM LANStreamer Adapter and IBMTRDBO LAN driver
may recover from these errors.
If this counter continues to increase, Run the
adapter diagnostic tests located on the Option
that was shipped with the
IBM LANStreamer Adapter. If there are no problems with
the adapter, reload the IBMTRDBO LAN driver.
If a problem was found, follow the instructions
supplied with the diagnostic tests to correct the
problem.
Adapter Detected Parity Errors
Description: This counter is incremented when the LANStreamer Adapter
detects a parity error while data is being transferred
between the IBM LANStreamer Adapter and the computer.
Cause/Action: If this counter continues to increase, it may indicate a
problem with your computer or the IBM LANStreamer Adapter.
Run the adapter diagnostic tests located on the Option
Diskette that was shipped with the IBM LANStreamer
Adapter. If there are no problems with the adapter
reload the IBMTRDBO LAN driver. If a problem was found,
follow the instructions supplied with the diagnostic tests
to correct the problem.
Adapter RAM Access Errors
Description: This counter is incremented when the LANStreamer Adapter
reports a RAM access violation.
Cause/Action: If this counter continues to increase, and you are
experiencing problems with the IBM LANStreamer Adapter,
run the adapter diagnostic tests located on the Option
Diskette that was shipped with the IBM LANStreamer
Adapter. If there are no problems with the adapter,
reload the IBMTRDBO LAN driver. If this problem still
exists, contact your network administrator or IBM
support center.
Micro Channel Errors
Description: This counter indicates the number of Micro Channel
bus errors that were detected.
ODI for IBM LANStreamer Adapter, Version 1.0 March 26, 1993 10
Cause/Action: The IBM LANStreamer Adapter detected an error with
the Micro Channel bus while accessing or attempting
to access the bus.
If this counter continues to increase, run the
diagnostics on the reference diskette that came with
your computer to test for problems with the Micro
Channel bus.
Receive Overrun Errors
Description: This counter is incremented when the IBM LANStreamer Adapter
receives a frame from the token-ring network
faster than it can be moved into computer memory.
Cause/Action: If this counter continues to increase, run the
diagnostics on the reference diskette that came with
your computer to test for problems with the Micro Channel
bus. If this problem still persists, contact you
network administrator or IBM support center.
Transmit Underrun Errors
Description: This counter is incremented when the IBM LANStreamer Adapter
attempts to transmit a frame to the token-ring network
but cannot move the frame fast enough from computer
memory to the network.
Cause/Action: If this counter continues to increase, run the
diagnostics on the reference diskette that came with
your computer to test for problems with the Micro Channel
bus. If this problem still persists, contact your
IBM support center.
Transmit Checksum Errors
Description: This counter is incremented when the transmission of
a frame completes and the checksum value for the frame
is incorrect.
Cause/Action: If this counter continues to increase, contact
your network administrator or IBM support center.
ODI for IBM LANStreamer Adapter, Version 1.0 March 26, 1993 11
MESSAGES FOR THE IBMTRDBO LAN DRIVER
IBMTRDBO-xx-071: The matching virtual adapter could not be found.
Cause: An error occurred while trying to load another copy
of the IBMTRDBO LAN driver to support an additional
frame type (FRAME= parameter) on an IBM LANStreamer
Adapter. The MSM could not find a previous copy of
the IBMTRDBO LAN driver required to load the specified
frame type.
Action: Obtain the most current copy of the MSM.NLM or
MSM31X.NLM (if running NetWare version 3.1x), and then
reload the IBMTRDBO LAN driver for the desired frame
types. If this error persists, contact your network
administrator or IBM support center. Refer to the
NOVELL NETWARE SYSTEM ADMINISTRATION manual for
information about loading and unloading LAN drivers.
IBMTRDBO-xx-072: A resource tag is unavailable.
Cause: The NetWare operating system was unable to allocate
memory for a resource tag. The IBMTRDBO LAN driver
did not load because required internal resources
were not available. There may be too many NetWare
Loadable Modules (NLMs) running in the NetWare Server.
Action: Unload the NLMs that are loaded but are not being used,
and then load the IBMTRDBO LAN driver. If this error
persists, down, exit and then restart the server. Load
the IBMTRDBO LAN driver before loading NLMs. This may
require you to edit the AUTOEXEC.NCF file before restarting
the server. Refer to NOVELL NETWARE SYSTEM ADMINISTRATION
for information about the AUTOEXEC.NCF file.
IBMTRDBO-xx-073: Unable to allocate memory.
Cause: The NetWare operating system was unable to allocate
memory for the IBMTRDBO LAN driver. The IBMTRDBO
LAN driver did not load.
Action: Unload the NetWare Loadable Modules (NLMs) that are
loaded but are not being used, and then load the IBMTRDBO
LAN driver. If this error persists, down, exit and then
restart the server. Load the IBMTRDBO LAN driver before
loading NLMs. This may require you to edit the
AUTOEXEC.NCF file before restarting the server. Refer to
NOVELL NETWARE SYSTEM ADMINISTRATION for information
about the AUTOEXEC.NCF file.
IBMTRDBO-xx-074: The hardware interrupt cannot be set.
ODI for IBM LANStreamer Adapter, Version 1.0 March 26, 1993 12
Cause: The NetWare operating system was unable to set the
hardware interrupt level requested by the IBMTRDBO
LAN driver. The IBMTRDBO LAN driver did not load.
Action: Try to load the IBMTRDBO LAN driver again. If the error
persists, contact your network administrator or IBM
support center.
IBMTRDBO-xx-075: The MLID cannot be registered with the LSL.
Cause: The IBMTRDBO LAN driver could not be registered with the
Link Support Layer (LSL) module. The maximum number of
LAN drivers have already been loaded or there was not
enough memory to load the IBMTRDBO LAN driver. The IBMTRDBO
LAN driver did not load.
Action: Unload LAN drivers that are not being used and then
load the IBMTRDBO LAN driver. If this error persists,
down, exit and then restart the server. Load the IBMTRDBO
LAN driver before loading other LAN drivers. This may
require you to edit the AUTOEXEC.NCF file before restarting
the server. Refer to NOVELL NETWARE SYSTEM ADMINISTRATION
for information about the AUTOEXEC.NCF file.
IBMTRDBO-xx-076: The polling procedure cannot be added.
Cause: Too many polling processes are registered with
the NetWare operating system. The IBMTRDBO LAN
driver did not load.
Action: Unload LAN drivers or NetWare Loadable Modules that
are loaded but are not being used. Try to load the
IBMTRDBO LAN driver again. If this error persists,
contact your network administrator or IBM support
center.
IBMTRDBO-xx-077: The event notification routine cannot be registered.
Cause: The NetWare operating system was unable to allocate
memory to register the IBMTRDBO LAN driver event
notification routine. The IBMTRDBO LAN driver did
not load.
Action: Unload LAN drivers or NetWare Loadable Modules that
are loaded but are not being used. Try to load the
IBMTRDBO LAN driver again. If this error persists,
contact your network administrator or IBM support
center.
ODI for IBM LANStreamer Adapter, Version 1.0 March 26, 1993 13
IBMTRDBO-xx-078: The firmware file cannot be read.
Cause: The Netware operating system was unable to load the
IBMTRDBO LAN driver. The IBMTRDBO LAN driver was not
loaded.
Action: Obtain another copy of the IBMTRDBO LAN driver from
the original distribution diskette. Reload the IBMTRDBO
LAN driver. If this error persists, contact your network
administrator or IBM support center.
IBMTRDBO-xx-084: Unable to allocate memory below 16 Megabyte boundary.
Cause: The Netware operating system ran out of memory buffers
below 16 megabytes. The IBMTRDBO LAN driver was not
loaded.
Action: Set the Reserved Buffers Below 16 Meg parameter in the
STARTUP.NCF to a larger number.
IBMTRDBO-xx-086: The driver parameter block is too small.
Cause: The IBMTRDBO.LAN file is designed to run with an older
version of the MSM.NLM. The IBMTRDBO LAN driver was
not loaded.
Action: Obtain an older version of the MSM.NLM or a newer
version of the IBMTRDBO.LAN file.
IBMTRDBO-xx-087: The media parameter block is too small.
Cause: The TOKENTSM.NLM NetWare Loadable Module (NLM) is
designed to run with an older version of the MSM.NLM
or MSM31X.NLM if running NetWare Version 3.1x.
Action: Obtain an older version of the MSM.NLM (MSM31X.NLM
if running NetWare Version 3.1x) or a new version of
the TOKENTSM.NLM.
IBMTRDBO-xx-091: The hardware configuration conflicts.
Cause: The IBMTRDBO LAN driver requested use of a hardware
resource that was already being used by another
hardware device. The IBMTRDBO LAN driver did not load.
Action: Change the hardware configuration of the IBM LANStreamer
Adapter or the hardware configuration of the conflicting
hardware device.
ODI for IBM LANStreamer Adapter, Version 1.0 March 26, 1993 14
IBMTRDBO-xx-092: Cannot schedule AES without an HSM routine.
Cause: The IBMTRDBO.LAN file is damaged.
Action: Obtain another copy of the IBMTRDBO LAN driver from
the original distribution diskette. Reload the IBMTRDBO
LAN driver. If this error persists, contact your network
administrator or IBM support center.
IBMTRDBO-xx-093: Cannot schedule interrupt time call back without an
HSM routine.
Cause: The IBMTRDBO.LAN file is damaged.
Action: Obtain another copy of the IBMTRDBO LAN driver from
the original distribution diskette. Reload the IBMTRDBO
LAN driver. If this error persists, contact your network
administrator or IBM support center.
IBMTRDBO-xx-094: Cannot set hardware interrupt without an HSM routine.
Cause: The IBMTRDBO.LAN file is damaged.
Action: Obtain another copy of the IBMTRDBO LAN driver from
the original distribution diskette. Reload the IBMTRDBO
LAN driver. If this error persists, contact you network
network administrator or IBM support center.
IBMTRDBO-xx-095: Cannot add polling without an HSM routine.
Cause: The IBMTRDBO.LAN file is damaged.
Action: Obtain another copy of the IBMTRDBO LAN driver from
the original distribution diskette. Reload the IBMTRDBO
LAN driver. If this error persists, contact your network
administrator or IBM support center.
IBMTRDBO-xx-126: The group bit in the node address override was cleared.
Cause: The address specified for the node address parameter
is an incorrect adapter node address. The group
address bit for the node address specified had been
set. The group address bit was cleared by the IBMTRDBO
LAN driver. The IBMTRDBO LAN driver was loaded.
Action: Correct the node address parameter to specify a locally
administered address according to the IBM TOKEN-RING
NETWORK ARCHITECTURE REFERENCE. On a DOS or
OS/2 workstation, change the node address parameter in
ODI for IBM LANStreamer Adapter, Version 1.0 March 26, 1993 15
the NET.CFG file. On a NetWare Server, change the node
address parameter specified on the command line when the
IBMTRDBO LAN driver was loaded, or change the node address
specified in the IBMTRDBO.CFG configuration file.
IBMTRDBO-xx-127: The local bit in the node address override was set.
Cause: The address specified for the node address parameter
is an incorrect adapter node address. The node address
specified does not have the locally administered address
bit set. The locally administered address bit was set
by the IBMTRDBO LAN driver. The IBMTRDBO LAN driver was
loaded.
Action: Correct the node address parameter to specify a locally
administered address according to the IBM TOKEN-RING
ARCHITECTURE REFERENCE. On a DOS or OS/2
workstation, change the node address parameter in the
NET.CFG file. On a NetWare server change the node
address parameter specified on the command line when the
IBMTRDBO LAN driver was loaded, or change the node address
specified in the IBMTRDBO.CFG configuration file.
IBMTRDBO-xx-200: Initializing the IBM LANStreamer Adapter ... please wait.
Cause: The IBM LANStreamer Adapter initialization process has
started.
Action: None.
IBMTRDBO-xx-202: The IBM LANStreamer Adapter is closed.
Cause: The IBMTRDBO LAN driver could not insert the IBM
LANStreamer Adapter into the ring due to previosly
reported hardware problems. The IBMTRDBO LAN driver
has closed the adapter and has generated an alert
after trying to insert the adapter into the ring
several times.
Action: Follow the recommended action for correcting any error
messages displayed by the IBMTRDBO LAN driver before
this one.
IBMTRDBO-xx-204: The IBM LANStreamer Adapter requires a computer with a
Micro Channel bus.
Cause: The IBM LANStreamer Adapter will work only in a computer
that supports the IBM Micro Channel Architecture.
Action: Install the IBM LANStreamer Adapter and IBMTRDBO LAN
ODI for IBM LANStreamer Adapter, Version 1.0 March 26, 1993 16
driver in a computer that supports the IBM Micro Channel
Architecture.
IBMTRDBO-xx-205: The IBMTRDBO LAN driver was not loaded because of an
incorrect keyword value.
Cause: The value for one of the keywords specified on the
command line or in the IBMTRDBO.CFG file was not within
the allowable range. The IBMTRDBO LAN driver did not
load.
Action: Correct the value of the keyword displayed in the
message that was displayed above this error message,
and reload the IBMTRDBO LAN driver.
IBMTRDBO-xx-207: The IBM LANStreamer Adapter could not be reset.
Cause: The IBMTRDBO LAN driver timed out while waiting for the
IBM LANStreamer Adapter to complete a hardware reset. The
IBMTRDBO LAN driver did not load.
Action: Restart your computer and try to load the IBMTRDBO LAN
driver again. If this error persists, contact your
network administrator or IBM support center.
IBMTRDBO-xx-209: The IBMTRDBO LAN driver failed to initialize the
IBM LANStreamer Adapter.
Cause: There was a problem while initializing the IBM LANStreamer
Adapter. There may be previous error messages above this
one or the IBM LANStreamer Adapter may not be responding.
Action: Correct any problems with error messages displayed
above this error message, and then reload the IBMTRDBO
LAN driver.
If this is the only error message that is displayed,
restart your computer and check the adapter by running
the adapter diagnostic tests located on the Option
Diskette that was shipped with the IBM LANStreamer Adapter.
Then, reload the IBMTRDBO LAN driver. If this error
persists, contact your network administrator or IBM
support center.
IBMTRDBO-xx-210: Could not find an IBM LANStreamer Adapter in this computer.
Cause: There is no IBM LANStreamer Adapter installed in this
computer. The IBMTRDBO LAN driver did not load.
Action: Install an IBM LANStreamer Adapter in this computer if it
ODI for IBM LANStreamer Adapter, Version 1.0 March 26, 1993 17
has a 80386 or higher microprocessor, and then reload the
IBMTRDBO LAN driver.
IBMTRDBO-xx-211: The IBM LANStreamer Adapter was not found in the specified
slot.
Cause: There is no IBM LANStreamer Adapter in the slot specified
by the SLOT keyword.
Action: Correct the SLOT keyword so that it indicates a slot
number in which an IBM LANStreamer Adapter is located, and
then reload the IBMTRDBO LAN driver.
If there is an IBM LANStreamer Adapter in the specified slot,
contact your network administrator or IBM support center.
IBMTRDBO-xx-212: Insufficient memory available for configured transmit and
receive buffers.
Cause: During initialization of the IBMTRDBO LAN driver, there
was insufficient memory available for the configured
number of transmit and receive buffers.
Action: Increase the number of buffers that the server operating
system can allocate by editing the STARTUP.NCF file on
the server. Increase the Minimum Packet Receive Buffers
server parameter in the STARTUP.NCF file by the total
number of transmit and receive buffers that the IBMTRDBO
LAN driver is using. Down, exit, and then restart the
NetWare Server.
If the IBM LANStreamer Adapter is installed in a 16-bit
slot in your computer, add or increase the following
parameter in the STARTUP.NCF file:
Set the Reserved Buffers Below 16 = total transmit and
receive buffers used by the IBMTRDBO LAN driver.
If this error still persists, unload the LAN drivers and
NetWare Loadable Modules (NLMs) that are loaded but are
not being used at the NetWare Server.
If this error still persists, decrease the number of
buffers that are being used by the IBMTRDBO LAN driver
by specifying the transmit and receive keywords for the
IBMTRDBO LAN driver.
See "Configurable IBMTRDBO LAN Driver Parameters"
for information about specifying keywords for the
operating system that you are using.
ODI for IBM LANStreamer Adapter, Version 1.0 March 26, 1993 18
IBMTRDBO-xx-213: The slot to use for IBM LANStreamer Adapter was not specified.
Cause: The IBMTRDBO LAN driver prompted the user to select a
slot number that has an IBM LANStreamer Adapter installed
but no choice was made.
Action: None. The IBMTRDBO LAN driver was not loaded.
IBMTRDBO-xx-215: The value specified for RXBUFFERS is not valid. The
value has been changed to the next supported value.
Cause: An incorrect value was specified for RXBUFFERS either on
the command line or in the IBMTRDBO.CFG file for the
server. The IBMTRDBO LAN driver used the next lower
supported value from the one specified.
Action: None. However, to keep this message from being displayed
when the IBMTRDBO LAN driver is loaded, change the value
specified by the RXBUFFERS keyword to one of the supported
values for your operating system.
See "Configurable IBMTRDBO LAN Driver Parameters"
for the supported values.
IBMTRDBO-xx-216: The value specified for TXBUFFERS is not valid. The
value has been changed to the next supported value.
Cause: An incorrect value was specified for TXBUFFERS either on
the command line or in the IBMTRDBO.CFG file for the
server. The IBMTRDBO LAN driver used the next lower
supported value from the one specified.
Action: None. However, to keep this message from being displayed
when the IBMTRDBO LAN driver is loaded, change the value
specified by the TXBUFFERS keyword to one of the supported
values for your operating system.
See "Configurable IBMTRDBO LAN Driver Parameters"
for the supported values.
IBMTRDBO-xx-219: An internal error was reported when the IBM LANStreamer
Adapter tried to insert into the ring.
Cause: The open adapter command issued by the IBMTRDBO LAN
driver to insert into the ring failed. An alert was
generated by the IBMTRDBO LAN driver.
Action: Restart the computer and try to load the IBMTRDBO LAN
driver again. If this message continues to occur,
check the adapter by running the adapter diagnostic tests
located on the Option Diskette that was shipped with the
IBM LANStreamer Adapter. If there is a problem with the
adapter hardware, contact your network administrator or
ODI for IBM LANStreamer Adapter, Version 1.0 March 26, 1993 19
IBM support center. If there are no problems with the
adapter hardware, report this problem to your IBM support
center.
IBMTRDBO-xx-220: The LANStreamer Adapter could not insert into the ring.
Cause: The adapter performs a number of tests when it
attempts to insert into the ring. This message
indicates that one of the tests failed and the
adapter could not insert into the ring.
Action: Restart the computer and try to load the IBMTRDBO LAN
driver again. If this message continues to occur,
check the adapter by running the adapter diagnostic tests
located on the Option Diskette that was shipped with the
IBM LANStreamer Adapter. If there is a problem with the
adapter hardware, contact your network administrator or
IBM support center.
IBMTRDBO-xx-221: The IBM LANStreamer Adapter received a disconnect frame
from another token-ring Adapter.
Cause: The IBM LANStreamer Adapter received a disconnect frame
request that was sent by another token-ring adapter at
a remote station. The IBM LANStreamer Adapter installed
in this computer disconnected from the ring.
Action: To insert the IBM LANStreamer Adapter back into the ring,
unload the IBMTRDBO LAN driver and then reload it. If
this error persists, contact your network administrator
or IBM support center.
IBMTRDBO-xx-222: The IBM LANStreamer Adapter could not insert into the
ring because the ring is beaconing.
Cause: The token-ring LAN segment to which the IBM LANStreamer
adapter is connected is beaconing. The adapter could
not insert into the ring. An alert was generated by
the IBMTRDBO LAN driver.
Action: The IBMTRDBO LAN driver will try to insert into the
ring three more times. This alert condition is corrected
when the IBMTRDBO-NW-231 message is displayed. If
this condition does not correct itself, contact
your network administrator or IBM support center.
IBMTRDBO-xx-223: The IBM LANStreamer Adapter failed to insert into the ring;
another adapter is using the same node address.
Cause: The IBM LANStreamer Adapter could not insert into the ring
ODI for IBM LANStreamer Adapter, Version 1.0 March 26, 1993 20
because another station is using the same value that was
specified for the node address parameter at your station.
Action: Change the node address parameter value specified for
your station. This parameter is specified as NODE=
at the NetWare Server.
See "Configurable IBMTRDBO LAN Driver Parameters"
for more information about configuration parameters.
IBMTRDBO-xx-224: The IBM LANStreamer Adapter detected a wire fault error
and closed the adapter.
Cause: The connection between the IBM LANStreamer Adapter and
the LAN has been broken. The adapter or the adapter
cable may have developed a problem.
Action: Check the connection between the adapter and cable
by running the adapter diagnostic tests located
on the Option Diskette that was shipped with the
IBM LANStreamer Adapter.
IBMTRDBO-xx-225: The token-ring network is beaconing.
Cause: The token-ring LAN segment to which the IBM LANStreamer
adapter is connected is beaconing. The ring is
experiencing an error condition detected by the adapter
when there is either a signal loss (possibly caused by a
broken line) or no token circulating the ring within the
predefined time limit.
Action: Contact your network administrator.
IBMTRDBO-xx-228: A Micro Channel error occurred; the adapter was reset.
Cause: An error was detected with the Micro Channel bus while
data was being transferred between the IBM LANStreamer
Adapter and the computer. This condition is reported as
an alert.
Action: The adapter will retry the data transfer, and the
IBMTRDBO LAN driver Micro Channel Error statistics counter
will be incremented.
If this error persists, check the adapter by running the
adapter diagnostic tests located on the Option Diskette
that was shipped with the IBM LANStreamer Adapter, and check
your computer by running the hardware diagnostic tests. If
this error still persists, contact your IBM support center
or place of purchase of the IBM LANStreamer Adapter.
ODI for IBM LANStreamer Adapter, Version 1.0 March 26, 1993 21
IBMTRDBO-xx-229: The IBM LANStreamer Adapter reported a hardware error.
Cause: The IBM LANStreamer Adapter reported an adapter hardware
error. The adapter was closed.
Action: The IBMTRDBO LAN driver will increment the Adapter
Hardware Error counter, issue an alert, and try to reset
the adapter. The IBM LANStreamer Adapter and IBMTRDBO
LAN driver may recover from this error. If not, run
the adapter diagnostic tests located on the Option
Diskette that was shipped with the IBM LANStreamer Adapter.
If there are no problems with the adapter, reload the
IBMTRDBO LAN driver. If a problem was found, follow
the instructions supplied with the diagnostic tests to
correct the problem.
IBMTRDBO-xx-231: The alert condition was corrected.
Cause: The IBM LANStreamer Adapter, IBMTRDBO LAN driver, or
token-ring network have recovered from a previously
reported alert condition.
Action: None.
IBMTRDBO-xx-232: The IBM LANStreamer Adapter detected a parity error.
Cause: The IBM LANStreamer Adapter detected a parity error
while data was being transferred between the IBM
LANStreamer Adapter and the computer.
Action: The IBMTRDBO LAN driver will increment the Adapter
Detected Parity Error counter, and this condition
is reported as an alert. The IBM LANStreamer Adapter
and IBMTRDBO LAN driver may recover from this error.
If not, run the adapter diagnostic tests located on
the Option Diskette that was shipped with the IBM
LANStreamer Adapter. If there are no problems with
the adapter, reload the IBMTRDBO LAN driver. If a
problem was found, follow the instructions supplied
with the diagnostic tests to correct the problem.
IBMTRDBO-xx-233: The IBM LANStreamer Adapter reported a RAM access violation.
Cause: The IBM LANStreamer Adapter reported a RAM access
violation. The IBMTRDBO LAN driver may have tried to
access RAM on the LANStreamer adapter that was not
accessible.
Action: The IBMTRDBO LAN driver will increment the Adapter
RAM Access Error counter, and this condition is reported
as an alert. The IBM LANStreamer Adapter and IBMTRDBO
ODI for IBM LANStreamer Adapter, Version 1.0 March 26, 1993 22
LAN driver may recover from this error. If not, run the
adapter diagnostic tests located on the Option Diskette that
was shipped with the IBM LANStreamer Adapter. If
there are no problems with the adapter, reload the
IBMTRDBO LAN driver. If a problem was found, follow
the instructions supplied with the diagnostic tests to
correct the problem.
ODI for IBM LANStreamer Adapter, Version 1.0 March 26, 1993 23
+-------------------------------------------------------+
| HEADINGS |
+-------------------------------------------------------+
__ ____ ____ __________ ID FILE PAGE REFERENCES
ODITI ODIREAD SCRIPT
1 ODI for IBM
LANStreamer Adapter,
Version 1.0 March
26, 1993
INST ODIINST
2 IBMTRDBO LAN Driver
Installation
Procedure
MIB ODIMIB2
5 Configurable IBMTRDBO
LAN Driver
Parameters
8, 18, 19, 19,
21
IBMCFG ODIMIB2
7 Sample IBMTRDBO.CFG
Configuration File
for NetWare Server
4, 5, 5
PERF ODIPERF
8 IBMTRDBO LAN Driver
Performance Tuning
COUNT ODICOUNT
9 IBM LANStreamer
Adapter Custom
Statistic Counters
MSGS ODIMSGS
12 Messages for the
IBMTRDBO LAN Driver
+-------------------------------------------------------+
| LIST ITEMS |
+-------------------------------------------------------+
__ ____ ____ __________ ID FILE PAGE REFERENCES
DIR3 ODIINST
3 1
CPY3 ODIINST
3 2
3
+-------------------------------------------------------+
| REVISIONS |
+-------------------------------------------------------+
__ ____ ____ __________ ID FILE PAGE REFERENCES
R1 ODIREAD SCRIPT
1
5, 5, 5
R2 ODIREAD SCRIPT
1
7
R3 ODIREAD SCRIPT
1
R4 ODIREAD SCRIPT
1
+-------------------------------------------------------+
| PROCESSING OPTIONS |
+-------------------------------------------------------+
Runtime values:
Document fileid ........................ ODIREAD SCRIPT
Document type .......................... USERDOC
Document style ......................... IBMXAGD
Profile ................................ EDFPRF30
Service Level .......................... 0029
SCRIPT/VS Release ...................... 4.0.0
Date ................................... 93.03.08
Time ................................... 01:50:09
Device ................................. 3270
Number of Passes ....................... 3
Index .................................. NO
Formatting values used:
Annotation ............................. NO
Cross reference listing ................ YES
Cross reference head prefix only ....... NO
Dialog ................................. LABEL
Duplex ................................. NO
DVCF conditions file ................... (none)
DVCF value 1 ........................... (none)
DVCF value 2 ........................... (none)
DVCF value 3 ........................... (none)
DVCF value 4 ........................... (none)
DVCF value 5 ........................... (none)
DVCF value 6 ........................... (none)
DVCF value 7 ........................... (none)
DVCF value 8 ........................... (none)
DVCF value 9 ........................... (none)
Explode ................................ NO
Figure list on new page ................ YES
Figure/table number separation ......... YES
Folio-by-chapter ....................... NO
Head 0 body text ....................... (none)
Head 1 body text ....................... (none)
Head 1 appendix text ................... Appendix
Hyphenation ............................ NO
Justification .......................... NO
Language ............................... ENGL
Layout ................................. 1
Leader dots ............................ YES
Master index ........................... (none)
Partial TOC (maximum level) ............ 4
Partial TOC (new page after) ........... PAGE
Print example id's ..................... NO
Print cross reference page numbers ..... NO
Process value .......................... (none)
Punctuation move characters ............ .,
Read cross-reference file .............. (none)
Running heading/footing rule ........... NONE
Show index entries ..................... NO
Table of Contents (maximum level) ...... 3
Table list on new page ................. YES
Title page (draft) alignment ........... RIGHT
Write cross-reference file ............. (none)
+-------------------------------------------------------+
| Imbed Trace |
+-------------------------------------------------------+
Page 2 ODIPLAT
Page 2 ODIINST
Page 4 ODIMIB2
Page 7 ODIPERF
Page 8 ODICOUNT
Page 11 ODIMSGS